home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mintmant / dopendir.txt < prev    next >
Text File  |  1992-03-24  |  2KB  |  64 lines
  1. Dopendir(2)               Oct. 1, 1991                Dopendir(2)
  2.  
  3.  
  4.  
  5. NAME
  6.      Dopendir - open a directory for reading
  7.  
  8. SYNOPSIS
  9.      LONG Dopendir( char *name, WORD flag );
  10.  
  11. DESCRIPTION
  12.      Dopendir opens the directory whose name  is  pointed  to  by
  13.      name  for  reading.  A  32  bit directory handle is returned
  14.      which may be passed to Dreaddir to actually read the  direc-
  15.      tory.   flag  controls the way directory operations are per-
  16.      formed. If flag == 1, then the directory is read in  "compa-
  17.      tibility"  mode,  if flag == 0 then directory operations are
  18.      performed in "normal" mode. In  "compatibility"  mode,  file
  19.      systems  act  as  if  the  Fsfirst and Fsnext functions were
  20.      being used; in particular, if it is possible file names will
  21.      be  restricted  to  the  DOS  8 character name + 3 character
  22.      extension convention, and will be in upper case.   In  "nor-
  23.      mal" mode, file systems do not attempt to restrict the range
  24.      of names. Moreover, in this mode the  Dreaddir  system  call
  25.      will  also  return  a file index number (similar to the Unix
  26.      inode number) along with the file name.
  27.  
  28.      New programs should generally use normal mode  where  possi-
  29.      ble.
  30.  
  31. RETURNS
  32.      A 32 bit directory handle, on success.  Note that this  han-
  33.      dle may be negative, but will never contain the pattern 0xFF
  34.      in the upper byte, whereas all errors do contain  this  pat-
  35.      tern in the upper byte.
  36.  
  37.      EPTHNF if name is not a valid directory
  38.  
  39.      EACCDN if the directory is not accessible by this program
  40.  
  41.      ENSMEM if the kernel is unable to allocate memory needed for
  42.      the directory operations
  43.  
  44. SEE ALSO
  45.      Dclosedir(2), Dreaddir(2), Drewinddir(2)
  46.  
  47. BUGS
  48.      Failure to call Dclosedir() when the search  is  done  could
  49.      result in the system eventually running out of file indices;
  50.      this is fatal.  So always call Dclosedir() when you're  fin-
  51.      ished with the directory search!
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 0.9   Last change: MiNT Programmer's Manual             1
  61.  
  62.  
  63.  
  64.